This appendix describes the command-line arguments accepted by . These options override defaults as well as any values or flags given in the input file, and are thus useful for generating test and other unusual, ``non-standard'' renderings.
The general form of a command line is:
rayshade [Options] [filename]
If given, the input file is read from filename. By default, the input file is read from the standard input. Recall that, by default, the image file is written to the standard output; you will need to redirect the standard output if you have not chosen to write the image to a file directly. The name of the input file may be given anywhere on the command line.
Command-line options fall into two broad categories: those that set numerical or other values and thus must be followed by further arguments, and those that simply turn features on and off. 's convention is to denote the value-setting arguments using capital letters, and feature-toggling arguments using lower-case letters.
The default starting frame is number zero.
This option is only available when the Utah Raster Toolkit is
being used.
Overrides the value specified via the cutoff keyword.
When given, this option indicates that the image file being written
to contains a partially-completed image. will read the
image to determine the scanline from which to continue the rendering.
This option is only available with the Utah Raster Toolkit.
The -O option must also be used.
Overrides the value specified in the input file via the maxdepth
keyword.
Overrides the value specified via the eyesep keyword.
This option is only available for use with the Utah Raster Toolkit.
See the Utah Raster Toolkit's unexp manual page for details on
exponential RLE files.
Overrides the value given using the report keyword.
This option should be used when rendering polygons defined
by vertices given in clockwise
order, rather than counter-clockwise order as
expected by .
The default value for gamma is 1.0.
Overrides the filter selected through the use of the filter
keyword.
Rather than containing coverage information, the alpha channel values
will be restricted to zero, indicating no supersampling, and full intensity,
indicating supersampling. This option is only available if the Utah
Raster Toolkit is being used.
This option overrides any value specified through the use of the
frames keyword. By default, a single frame is rendered.
This option overrides the name given with the outfile keyword,
if any,
in the input file.
This option is equivalent to specifying shadowtransp
in the input file. By default, traces shadow
rays through non-opaque objects.
The C preprocessor, if available, is applied to all of the input
passed to rayshade.
This option is equivalent to -n -S 1 -D 0.
This option overrides any screen size set by use of
the screen keyword.
This option overrides any value set through the use of
the samples keyword in the input file.
It should never be necessary to use this option.
This option overrides any value given through the use of
the contrast keyword.
usually feeds its input through a
C preprocessor if one is available on your system.
If this option is given, unadulterated input files will
be used.
This option overrides any file named through the use of
the report keyword.
When given, this option causes information about the options
selected and the objects defined to be included in the
report file.
The window must be properly contained within the screen. This
option overrides any window specified using the window keyword
in the input file.
This option is provided to facilitate changing and/or examining a
small portion of an image without having to re-render the entire
image.